<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Traffic Functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><meta name="keywords" content="Intellon, Atheros, Qualcomm, HomePlug, powerline, communications, INT6000, INT6300, INT6400, AR7400, AR7420"><link rel="home" href="index.html" title="Qualcomm Atheros Open Powerline Toolkit"><link rel="up" href="ch07.html" title="Chapter 7.  Support Function Reference"><link rel="prev" href="ch07s10.html" title="Procrastination Functions"><link rel="next" href="ch07s12.html" title="SLAC Functions and Variables"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">
		Traffic Functions
		</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch07s10.html">Prev</a> </td><th width="60%" align="center">Chapter 7. 
		Support Function Reference
		</th><td width="20%" align="right"> <a accesskey="n" href="ch07s12.html">Next</a></td></tr></table><hr></div><div class="section" title="Traffic Functions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="support-traffic"></a>
		Traffic Functions
		</h2></div></div></div><p>
		Traffic functions generate powerline traffic in various ways. Some send traffic direct from the host to each device while others use the <code class="constant">VS_FR_LBK</code> message to echo Ethernet frames back to the sender.
		</p><div class="section" title="CrossTraffic1"><div class="titlepage"><div><div><h3 class="title"><a name="support-CrossTraffic1"></a>
			CrossTraffic1
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">CrossTraffic1</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			Instruct a powerline device  to send a generic Ethernet frame to another powerline device for a fixed period of time in order to set the <code class="constant">TX</code> rate on the source device and the <code class="constant">RX</code> rate on the destination device. The source and destination address are specified in <code class="varname">plc-&gt;MAC</code> and <code class="varname">plc-&gt;RDA</code>, respectively, and the duration is specified in <code class="varname">plc-&gt;timeperiod</code>. This function is similar to function <a class="link" href="ch07s11.html#support-CrossTraffic2" title="CrossTraffic2">CrossTraffic2</a> but the source and destination addresses are reversed. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="CrossTraffic1.c.html" target="_top">CrossTraffic1.c</a>. 
			</p></div><div class="section" title="CrossTraffic2"><div class="titlepage"><div><div><h3 class="title"><a name="support-CrossTraffic2"></a>
			CrossTraffic2
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">CrossTraffic2</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			Instruct a powerline device  to send a generic Ethernet frame to another powerline device for a fixed period of time in order to set the <code class="constant">TX</code> rate on the source device and the <code class="constant">RX</code> rate on the destination device. The source and destination address are specified in <code class="varname">plc-&gt;RDA</code> and <code class="varname">plc-&gt;MAC</code>, respectively, and the duration is specified in <code class="varname">plc-&gt;timeperiod</code>. This function is similar to function <a class="link" href="ch07s11.html#support-CrossTraffic1" title="CrossTraffic1">CrossTraffic1</a> but the source and destination addresses are reversed. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="CrossTraffic2.c.html" target="_top">CrossTraffic2.c</a>. 
			</p></div><div class="section" title="LocalTraffic1"><div class="titlepage"><div><div><h3 class="title"><a name="support-LocalTraffic1"></a>
			LocalTraffic1
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">LocalTraffic1</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			Send a fixed number of generic frames from the local host a remote powerline device in order to set the <code class="constant">TX</code> rate on the local powerline device and the <code class="constant">RX</code> rate on the remote powerline device. The local and remote device address are specified in <code class="varname">plc-&gt;MAC</code> and <code class="varname">plc-&gt;RDA</code>, respectively, and the count is specified in <code class="varname">plc-&gt;count</code>. This function is similar to function <a class="link" href="ch07s11.html#support-LocalTraffic2" title="LocalTraffic2">LocalTraffic2</a> which instructs a remote device to echo frames back to the local device. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="LocalTraffic1.c.html" target="_top">LocalTraffic1.c</a>. 
			</p></div><div class="section" title="LocalTraffic2"><div class="titlepage"><div><div><h3 class="title"><a name="support-LocalTraffic2"></a>
			LocalTraffic2
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">LocalTraffic2</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			Instruct a remote powerline device to echo generic Ethernet frames back to the local host for a fixed period of time in order to set the <code class="constant">TX</code> rate on the remote powerline device and the <code class="constant">RX</code> rate on the local powerline device. The local and remote device address are specified in <code class="varname">plc-&gt;MAC</code> and <code class="varname">plc-&gt;RDA</code>, respectively, and the count is specified in <code class="varname">plc-&gt;count</code>. This function is useful when there is no easy way to send traffic from the remote host. This function complements function <a class="link" href="ch07s11.html#support-LocalTraffic1" title="LocalTraffic1">LocalTraffic1</a> which send frames from the local device to a remote device. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="LocalTraffic2.c.html" target="_top">LocalTraffic2.c</a>. 
			</p></div><div class="section" title="NetworkTraffic1"><div class="titlepage"><div><div><h3 class="title"><a name="support-NetworkTraffic1"></a>
			NetworkTraffic1
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">NetworkTraffic1</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			This function is an alternative to function <a class="link" href="ch07s11.html#support-NetworkTraffic2" title="NetworkTraffic2">NetworkTraffic2</a> which uses Qualcomm Version <code class="constant">1</code> management messages to determine network topology. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="NetworkTraffic1.c.html" target="_top">NetworkTraffic1.c</a>. 
			</p><p>
			This function use <code class="constant">VS_SW_INFO</code> and <code class="constant">VS_NW_INFO</code> messages to discover powerline network topology then calls functions <a class="link" href="ch07s11.html#support-LocalTraffic1" title="LocalTraffic1">LocalTraffic1</a> and <a class="link" href="ch07s11.html#support-LocalTraffic2" title="LocalTraffic2">LocalTraffic2</a> to generate traffic between the local powerline device and each remote powerline device. Unlike function <a class="link" href="ch07s11.html#support-NetworkTraffic1" title="NetworkTraffic1">NetworkTraffic1</a>, it does not generate traffic between various remote devices.
			</p></div><div class="section" title="NetworkTraffic2"><div class="titlepage"><div><div><h3 class="title"><a name="support-NetworkTraffic2"></a>
			NetworkTraffic2
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">NetworkTraffic2</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			This function is an alternative to function <a class="link" href="ch07s11.html#support-NetworkTraffic1" title="NetworkTraffic1">NetworkTraffic1</a> which uses Qualcomm Version <code class="constant">0</code> management messages to determine network topology. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="NetworkTraffic2.c.html" target="_top">NetworkTraffic2.c</a>. 
			</p></div><div class="section" title="Traffic1"><div class="titlepage"><div><div><h3 class="title"><a name="support-Traffic1"></a>
			Traffic1
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">Traffic1</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			This function is an alternative to function <a class="link" href="ch07s11.html#support-Traffic2" title="Traffic2">Traffic2</a> which uses Qualcomm Version <code class="constant">1</code> management messages to determine network topology. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="Traffic1.c.html" target="_top">Traffic1.c</a>. 
			</p><p>
			This function use <code class="constant">VS_SW_INFO</code> and <code class="constant">VS_NW_INFO</code> messages to discover powerline network topology then calls functions <a class="link" href="ch07s11.html#support-LocalTraffic1" title="LocalTraffic1">LocalTraffic1</a> and <a class="link" href="ch07s11.html#support-LocalTraffic2" title="LocalTraffic2">LocalTraffic2</a> to generate traffic between the local powerline device and each remote powerline device. Unlike function <a class="link" href="ch07s11.html#support-NetworkTraffic1" title="NetworkTraffic1">NetworkTraffic1</a>, it does not generate traffic between remote devices.
			</p></div><div class="section" title="Traffic2"><div class="titlepage"><div><div><h3 class="title"><a name="support-Traffic2"></a>
			Traffic2
			</h3></div></div></div><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">signed <b class="fsfunc">Traffic2</b>(</code></td><td><var class="pdparam">plc</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>struct plc * <var class="pdparam">plc</var></code>;</div><div class="funcprototype-spacer"> </div></div><p>
			This function is an alternative to function <a class="link" href="ch07s11.html#support-Traffic1" title="Traffic1">Traffic1</a> which uses Qualcomm Version <code class="constant">0</code> management messages to determine network topology. Structure <code class="varname">plc</code> is declared in file <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="plc.c.html" target="_top">plc.c</a>. The function is declared in <a class="ulink" href="plc.h.html" target="_top">plc.h</a> and defined in file <a class="ulink" href="Traffic2.c.html" target="_top">Traffic2.c</a>. 
			</p><p>
			This function use <code class="constant">VS_SW_INFO</code> and <code class="constant">VS_NW_INFO</code> messages to discover powerline network topology then calls functions <a class="link" href="ch07s11.html#support-LocalTraffic1" title="LocalTraffic1">LocalTraffic1</a> and <a class="link" href="ch07s11.html#support-LocalTraffic2" title="LocalTraffic2">LocalTraffic2</a> to generate traffic between the local powerline device and each remote powerline device. Unlike function <a class="link" href="ch07s11.html#support-NetworkTraffic2" title="NetworkTraffic2">NetworkTraffic2</a>, it does not generate traffic between remote devices.
			</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch07s10.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch07.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch07s12.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">
		Procrastination Functions
		 </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 
		SLAC Functions and Variables
		</td></tr></table></div></body></html>
